DisplayFrameConnected

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

DisplayFrameConnected
The DisplayFrameConnected method should add the specified frame to this part's internal list of display frames.
void DisplayFrameConnected (in ODFrame frame);
frame
A reference to a display frame to be connected.

DISCUSSION
OpenDoc calls this method when a previously stored display frame is initialized and reconnected to this part. When this part's document opens, or as each display frame of this part becomes visible through scrolling or resizing, OpenDoc calls this method when it or this part's containing part instantiates and connects one of this part's previously stored display frames.
Your part's DisplayFrameConnected method should update your part's internal list of display frames and other related structures to reflect the connection of the specified display frame. If the specified frame is already in the list, no action is taken. Your part should also update relevant information in the display frame, for example, its used shape and presentation.
Your part's DisplayFrameConnected method is typically called after OpenDoc or this part's containing part calls a draft's GetFrame method. By contrast, a part's DisplayFrameAdded method is called after OpenDoc or this part's containing part calls a draft's CreateFrame method.

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

EXCEPTIONS

kODErrInvalidFrame
The specified frame is not a display frame of this part.

SEE ALSO
The ODPart::DisplayFrameAdded method (page 494).
"The DisplayFrameConnected Method" on page 55 in OpenDoc Cookbook.
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Responding to Reconnected and Closed Display Frames" on page 106 in OpenDoc Programmer's Guide.
"Null Events" on page 194 in OpenDoc Programmer's Guide.
"On Closing and Reopening Documents" on page 212 in OpenDoc Programmer's Guide.
"Lazy Internalization" on page 473 in OpenDoc Programmer's Guide.